NOTIFY

Section: Misc. Reference Manual Pages (1M)
Updated: April 4, 1994
Index Return to Main Contents

NAME

notify - FlexFAX user notification script

SYNOPSIS

bin/notify qfile why jobtime pid number [ nextTry ]

DESCRIPTION

bin/notify is the command script invoked by the facsimile server to notify a user about the status of an outgoing facsimile job. The default notification script sends the appropriate user electronic mail describing the event or action. The arguments are:

qfile

the pathname of the job description file relative.

why

a string that specifies why the user is being notified; one of:

Why                 Notes    Meaning
done                         job was completed successfully
failed              + dd     job was not completed
requeued            dd       job was not completed, but was requeued for retry
removed                      job was deleted from the queue
killed              +        job was deleted from the queue
timedout            +        job could not be sent after repeated attempts
format_failed       +        conversion of PostScript failed
no_formatter        +        the PostScript to facsimile conversion program was not found
poll_rejected                a polling request was rejected by the remote side
poll_no_document             a polling request failed because nothing was available
poll_failed                  a polling request failed for an unknown reason
file_rejected                a submitted file was rejected, usually because of format

+ Any pages that were not sucessfully transmitted should be returned to the sender.
dd A transcript of the failed communication is returned to the sender with the transcript(1M) command.

jobtime

the total transmission time of a successful job or the connect time of a failed request (passed as a string).

pid

the process identifier of the facsmile server process that invoked the notification service.

number

the canonical phone number of the destination facsimile machine.

nextTry

the time (passed as a string) at which the next attempt will be made to complete the job. This parameter is passed only if why is ``requeued''.

NOTES

The following programs may be invoked to return unsent documents to the sender: tar(1), uuencode(1), and compress(1). Which programs and the exact format is site dependent.

FILES

${SPOOL}    spooling area
bin/transcriptfor returning communication transcript
/usr/lib/sendmailfor delivering mail

This document was created by man2html, using the manual pages.
Time: 10:15:15 GMT, January 04, 2023